home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat2 / ftn / sgikopt.z / sgikopt
Text File  |  1998-10-30  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))                                                          SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sgikopt - retrieve kernel option strings
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnntttteeeeggggeeeerrrr ****4444 ffffuuuunnnnccccttttiiiioooonnnn ssssggggiiiikkkkoooopppptttt ((((ooooppppttttiiiioooonnnn,,,, bbbbuuuuffff,,,, bbbbuuuufffflllleeeennnn))))
  13.      cccchhhhaaaarrrraaaacccctttteeeerrrr **** ((((****)))) ooooppppttttiiiioooonnnn
  14.      cccchhhhaaaarrrraaaacccctttteeeerrrr **** ((((****)))) bbbbuuuuffff
  15.      iiiinnnntttteeeeggggeeeerrrr ****4444 bbbbuuuufffflllleeeennnn
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The IRIX kernel saves most of the IRIS PROM Monitor environment variables
  19.      (option strings) for later use by the kernel as well as user programs.
  20.      _s_g_i_k_o_p_t allows the user to retrieve the values of these variables.  The
  21.      _o_p_t_i_o_n argument specifies the name of the variable; the value of the
  22.      option is returned in the buffer addressed by _b_u_f.  The size in bytes of
  23.      this buffer is given by _b_u_f_l_e_n.  The string returned by _s_g_i_k_o_p_t is
  24.      guaranteed to be null-terminated, even if the length of the option value
  25.      string exceeds _b_u_f_l_e_n.
  26.  
  27.      The environment variables recognized by _s_g_i_k_o_p_t are as follows:
  28.  
  29.  
  30.      bootfile       The name of the file to use for autobooting.
  31.  
  32.      bootmode       The type of boot performed:  mmmm to enter the PROM Monitor
  33.                     after clearing memory, dddd to enter the PROM Monitor without
  34.                     clearing memory, or cccc to perform an autoboot using the
  35.                     bootfile.
  36.  
  37.      console        The console to use:  gggg for graphics console, GGGG for
  38.                     graphics console with logo, or dddd for serial terminal port
  39.                     1.
  40.  
  41.      diskless       If this variable is set, the system expects to mount it's
  42.                     root filesystem via NFS from a server.  It may be set even
  43.                     if a local disk is installed, in which case the local root
  44.                     disk is ignored.
  45.  
  46.      dllogin        When _d_i_s_k_l_e_s_s is set, this is the login name to use during
  47.                     installation on a diskless machine.  See _c_l__i_n_i_t(1m) for
  48.                     more information.
  49.  
  50.      dlserver       When _d_i_s_k_l_e_s_s is set, this is the hostname of the machine
  51.                     from which the root filesystem will be mounted.  It should
  52.                     be set in standard IP address format.
  53.  
  54.      gfx            An variable indicating if graphics state:  aaaalllliiiivvvveeee or ddddeeeeaaaadddd....
  55.  
  56.      hostname       The Internet host name string.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))                                                          SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
  71.  
  72.  
  73.  
  74.      initfile       The process control initialization program if the default,
  75.                     /_e_t_c/_i_n_i_t, is overridden.  See _i_n_i_t(1M).
  76.  
  77.      initstate      The run level to override the default state present in
  78.                     /_e_t_c/_i_n_i_t_t_a_b. See _i_n_i_t_t_a_b(4).
  79.  
  80.      keybd          The international keyboard type.
  81.  
  82.      monitor        Overrides the default monitor setting when an unrecognized
  83.                     monitor is attached to an Indy system.  Specifying 'h' or
  84.                     'H' indicates the attached monitor supports high
  85.                     resolution mode (1280x1024 @ 60Hz).  Otherwise the default
  86.                     resolution is low resolution (1024x768 @ 60Hz).  This
  87.                     variable is usable only on an Indy system and is stored in
  88.                     non-volatile RAM.
  89.  
  90.      netaddr        The Internet network address for booting across the
  91.                     Ethernet.
  92.  
  93.      logocolor      The color of the logo while in the standalone programs,
  94.                     and the kernel textport (no window manager running) is
  95.                     controlled by this variable.  It is 6 hex digits, which
  96.                     are the values for red, green, and blue in that order.
  97.                     This is currently implemented only on the Personal Iris.
  98.  
  99.      nswap          The number of blocks to use in the swap partition; this
  100.                     amount overrides the partition size.
  101.  
  102.      pagecolor      The color of the textport while in the standalone
  103.                     programs, and the kernel textport (no window manager
  104.                     running) is controlled by this variable.  It is 6 hex
  105.                     digits, which are the values for red, green, and blue in
  106.                     that order.  This is currently implemented only on the
  107.                     Personal Iris.
  108.  
  109.      root           The disk that contains the root (/) file system (as it
  110.                     would be named in the /dev/dsk directory).
  111.  
  112.      screencolor    The color of the screen background while in the standalone
  113.                     programs, and the kernel textport (no window manager
  114.                     running) is controlled by this variable.  It is 6 hex
  115.                     digits, which are the values for red, green, and blue in
  116.                     that order.  This is currently implemented only on the
  117.                     Personal Iris.
  118.  
  119.      showconfig     If this variable is specified, the kernel will print out
  120.                     verbose information about memory and device configuration
  121.                     at boottime.
  122.  
  123.      srvaddr        If set, this specifies the (only) host that will be used
  124.                     to resolve bootp requests.  It should be set in standard
  125.                     IP address format.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))                                                          SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
  137.  
  138.  
  139.  
  140.      swaplo         The first block to use in the swap partition; this amount
  141.                     overrides the default value of 0.
  142.  
  143.      sync_on_green  If this value is nnnn, the sync information is not
  144.                     superimposed on the green monitor line.
  145.  
  146.      tapedevice     The tape device used for software installation.
  147.  
  148. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  149.      Upon successful completion, _s_g_i_k_o_p_t returns 0.  Otherwise, _s_g_i_k_o_p_t
  150.      returns -1 and sets _e_r_r_n_o to indicate the error:
  151.  
  152.  
  153.      [EINVAL]       The given _o_p_t_i_o_n was not found.
  154.  
  155.      [EFAULT]       The _o_p_t_i_o_n or _b_u_f argument specifies an invalid address.
  156.  
  157. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  158.      syssgi(2) - the SSSSGGGGIIII____GGGGEEEETTTTNNNNVVVVRRRRAAAAMMMM command provides almost the same
  159.      functionality.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.